.. _ecdiLtc_AddChannel:

ecdiLtc_AddChannel
'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
SYNOPSYS
`````````````
.. code-block:: none

  t_success ecdiLtc_AddChannel (
    t_i32 NetID, 
    t_ui32 DiChannel, 
    t_i32 *ErrCode)

  t_success ecdiLtc_AddChannel_L (
    t_i32 NetID, 
    t_ui16 SlvPhysAddr,
    t_i32 LocalChannel, 
    t_i32 *ErrCode)

DESCRIPTION
`````````````  
- 래치(Latch) 모드로 감시할 D/I 채널을 등록하는 함수입니다.

- 래치(Latch) 모드로 등록된 채널에 대해서는 ComiECAT 마스터 장치가 지속적으로 감시하면서 OFF에서 ON으로 바뀐 횟수를 기록하게 됩니다. 따라서 사용자는 입력 채널의 상태를 계속 감시하지 않아도 입력 채널의 상태가 OFF에서 ON으로 바뀐 횟수를 알 수 있습니다.


PARAMETER
`````````````

- NetID : Network 번호

- DiChannel : 디지털 입력 채널 번호

- SlvPhysAddr: 슬레이브 주소

- LocalChannel : 해당 디지털 입력 채널의 지역 채널 번호

- ErrCode : 이 매개 변수를 통하여 현재의 에러 코드를 반환합니다. 단, 이 매개 변수에 NULL을 전달하면 에러 코드를 반환하지 않습니다.


RETURN VALUE
`````````````
- 함수 수행의 성공 여부를 반환합니다.

+-------+--------------------------------------+
| Value | Meaning                              |
+=======+======================================+
| 0     | 함수 수행에 실패하였음을 의미합니다. |
+-------+--------------------------------------+
| 1     | 함수 수행에 성공하였음을 의미합니다. |
+-------+--------------------------------------+

EXAMPLE
`````````````

.. code-block:: cpp
 :linenos:

 #define NETID 0
 #define LTC_CH 0
 
 // OnStartLatchMon(): 래치모니터를 시작하는 가상의 사용자 함수 
 void OnStartLatchMon()
 {
	 t_i32 errCode;
	 if(!ecdiLtc_AddChannel(NETID, LTC_CH, &errCode)){
	 	// 에러처리
	 }
 }
 
 // OnTimer (): 래치 상태를 주기적으로 체크하는 가상의 사용자 함수 
 void OnTimer()
 {
	 if(ecdiLtc_GetOnCount(NETID, LTC_CH, true, NULL) > 0){
	 // 래치 발생함!
	 }
 }

.. seealso::
   :ref:`ecdiLtc_DelChannel`